Wad2Tool
Beta Version 0.8
Copyright (C) Richard Felker

Wad2Tool is a program designed to manipulate WAD2 files,
which contain the textures for Quake MAP levels. This
version is only a beta, so it is missing a few features,
but it is usable.

I will include source with the real version. It might
be helpful in case you would like to look at it or port
it (which should be very easy).

Wad2Tool is used from the command line. It is not for
beginners. All options are CASE-SENSITIVE! (except maybe
the name of the file on disk... :)

Usage: wad2tool <wad2file> [options]

<wad2file> is the name of the WAD2 you are using. It does
not have to exist at first if you will be "-create"ing it.
It will be used for all the commands you give Wad2Tool.

Options:

These options tell Wad2Tool what to do. If none are
specified, it will list all the entries in the WAD2 file.

-create
Creates a new WAD2 file. If <wad2file> already exists, it
is overwritten. Use this command with care!

-addlump <nameondisk> <nameinwad> <typechar>
Adds a raw lump to the WAD2 file. The data is read from
<nameondisk> and it stored in the WAD2 as <nameinwad>.
<typechar> is a single character telling the type of data.
'D' = texture and '@' = palette. Look in the Quake specs
for more.

-extlump <nameinwad> <nameondisk>
Extracts a lump named <nameinwad> and saves it as
<nameondisk>.

-dellump <nameinwad>
Removes the lump named <nameinwad> from the WAD2 file. This
operation only removes it from the wad directory; it still
takes up space. Use -rebuild (not yet implemented) to
recover the space.

-add <nameondisk> <nameinwad>
Generates a texture from a bitmap file, <nameondisk>, and
stores is in the WAD2 as <nameinwad>. The image is simply
shrunk for the 3 smaller versions (doesn't look great).

-addfull <basenameondisk> <nameinwad>
Generates a texture from 4 bitmap files whose names begin
with <basenameondisk> followed by a number (0,1,2,3) and
the extension ".bmp". The texture is stored in the WAD2 as
<nameinwad>.

-addauto <nameondisk> <nameinwad>
Will use a bitmap, <nameondisk> to automaticly generate an
antialiased MIP texture. The texture is added to the WAD2
as <nameinwad>. NOTE: THIS OPERATION IS NOT YET
IMPLEMENTED!

-ext <nameinwad> <basenameondisk>
Generates bitmap files from the 4 parts of a texture named
<nameinwad>. They are saved as <basenameondisk>?.bmp, where
the ? is a number (0,1,2,3) indicating which size.

-rebuild
Will clean up any unused space in the WAD2. NOTE: THIS
OPERATION IS NOT YET IMPLEMENTED!

Until -rebuild is implemented, I recommend re"-create"ing
the WAD2 with every change and adding all the data from a
batch file. That's the way I use it.

NOTE: Extracting a texture to a bitmap requires a palette.
The palette should be in a lump named "palette" in the WAD2
file. If it is not, extract it from PAK0.PAK (with an
unpacker) and put it in the WAD2 with -addlump.

Oh, one last thing - you use this program at your own risk.
I seriously doubt it will do anything to harm your system,
but I cannot guarantee it. If it does, write and tell me
and I'll try to help you fix it, if I can.

Dalias, 71614.3257@compuserve.com